Although the author used Radio Shack’s three-ROM BASIC, 
the two-ROM version should work as well. 



Richard J. Uschold 
80 Woodview Dr. 

Port Orange, FL 32019 



S ince I have been a dedicated 
hardware hacker for many 



^^hardware hacker for many 
years, I just had to build my own 
computer, i started designing at 
Christmas in 1976. By Septem- 
ber 1977 I had my computer 
basically working, and by 
Christmas 1977 it was working 
in BASIC. It was a 2K Tiny BASIC 
interpreter, but it was better 
than nothing. 

After about a year of using my 
Tiny BASIC, I decided I was 



ready for a real BASIC. Since ! 
had chosen the Z-80 micropro- 
cessor for my computer, I could 
use any BASIC written for the 
8080 or the Z-80. 

There were a number of BA- 
SICS available that required 
from 8K to 24K of memory at 
prices from $50 to several hun- 
dred dollars. I really liked the 
idea of having the BASIC in 
ROM so that I wouldn’t have to 
load it from tape every time, 
which seemed to take forever. 
(Even with my 2400 baud cas- 
sette interface, programs longer 
than 4K become annoying!)This 
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meant I had to either use 
EPROMs or buy the BASIC al- 
ready in ROM. The EPROMs 
would cost upwards of $80, plus 
the price of the BASIC. 

There was only one BASIC of- 
fered in ROM that I knew of, 
although I had heard rumors of 
another one coming soon. The 
rumors have since become fact, 
and Livermore BASIC is now 

available on an 8K byte ROM for 

$95. I bought the other one, 
Radio Shack’s Level II BASIC, 
for $89.10. (Several companies 
offer ten percent off Radio 
Shack’s original $99 price. 
Radio Shack has since raised 
the price to $120.) 

Radio Shack’s Level II BASIC 
has another significant advan- 
tage-software availability. 
Since it is the most popular 
microcomputer around today, it 
has much software designed for 
it. Also, many programs not orig- 
inally written for it are being of- 
fered in compatible forms (for 
example, the CP/M disk operat- 
ing system and the Electric Pen- 
cil). 

In this article, I will describe 
how I interfaced the Level II 
ROMs to my computer, even 
Though my hardware bears little 
resemblance to that of the 
TRS-80. I will also give some 
hints to those computerists 
whose hardware doesn’t resem- 
ble mine either! 



Fig. 1. TRS-80 keyboard connected to the address and data buses 
(Reprinted from the " TRS-80 Technical Reference Manual, 
courtesy Radio Shack.) 
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Preliminary Work 

Before I bought the Level II 
ROMs, I did some preliminary in- 
vestigation, which included re- 
reading articles that described 



the TRS-80 hardware and soft- 
ware. I also bought and read the 
“TRS-80 Microcomputer Techni- 
cal Reference Handbook” pub- 
lished by Radio Shack. All of 
this material provided several 
important pieces of information. 

First, the TVT was a more or 
less standard type of memory- 
mapped interface, which, I fig- 
ured, should present no prob- 
lems. 

Second, the keyboard was an 
unorthodox arrangement with 
the key matrix directly mapped 
in memory (see Fig. 1). 1 figured I 
could write a program to take 
ASCII data from my keyboard 
and calculate the required mem- 
ory bits to set so that the ROM 
could find the bits in memory 
and convert them back to ASCII 
(a kludge, but it worked!). 

Third, the cassette interface 
was software timed and would 
require a different clock rate on 
my processor or else some soft- 
ware patches to get the timing 
right. 

Finally, and perhaps most im- 
portantly, the ROMs were locat- 
ed in memory at address 0000H. 
This meant I would have to move 
my monitor, which was now 
there, to another address, t 
moved it to F000H. This required 
a reset vector other than 0000H 
to initialize to the monitor. 

The circuit I used was de- 
scribed in the September 1977 
Kilobaud (‘‘Using an Invisible 
PROM,” p. 106, by Jack Regula). 
My version is in Fig. 2. I spent 
the next month or so rewriting 
and improving my monitor. 
When I had it just right, I put it in 







eaiW ;TR5-S8 KEYHW® SYTOATC* INTERRWT MUTM 
0tfU0 ;£Y RICHARD J. USCHOLC 



00120 
0*120 TKE1NT 
08148 
08150 
80168 
60170 
091-58 
08190 
08288 
08210 

00220 OFiff 
6822' 

80248 
80258 
08260 
80278 
88288 
00298 
08200 
08218 
88220 
00150 
00248 
08258 



88260 Nft3fT 
00270 
08288 
08390 
08480 
80410 
60428 
88420 
00448 
88450 
08468 
88478 

00488 GENADR 

80498 

68588 

60510 DATA 

e8520 

00530 

68540 DATfti 

88550 

60568 

06578 CENDAI 
005-8 6 
08598 



080 067760 
FlEK HL 
FUSH AF 
FUSH EC 
LD A.3CH 
OUT UNTilSK 
El 

XGR fi 
ID E.8 
ID HL.3S01H 
LD 04.), ft 
RLC L 

DJIlZ ORLOP 
LD L.6FFH 
LD <H-),fl 
1H ft- 1KERD; 
LD C.ft 
BIT 7, A 
JR Z.NASHFT 
LD ft.1 
LD L.88H 
LD (TO. ft 
RES7.C 
LD R.C 
CP LFBRKT 



iSftVE REGISTERS 



ifSKK rERD AND LCilER WTS 
ft ,F3R If.' SYSTEM ONLY 

; CLEFS ft 
iLOOP CUM 
iKERD HEMCSV FDCRESS 
iCLEfft KERD ADDRESS 
.GENERATE NEXT ftBCRESS 

;KEV PRESSED BYTE 
.CLEFS IT 

,G£T DftTft FROM KEYBOARD 
jSflVE DATA 
; CHECK PLL SHIFT BIT 
IT ALL SHIFT 
YES-SHIFT BIT EftT« 
SHIFT ADDRESS 
SET SHIFT BIT 
CLEAR ft! SHIFT BIT 
GET DftTft 

UffER LIMIT CHRRfiCTER 



^Sdo'o-y^vyud^this 



00618 

00620 I.6ALIB 

80638 

06640 

00650 HCFLFH 
00660 
86670 
60680 
00698 
00708 
00716 
00728 SrfT 
00728 



CP ftTSH 
JR C,N0flLPH 
RRCfi 
RRCft 
RRCft 
H® 03 
INC ft 
LD B.ft 
XOR ft 
SCF 
Rlh 

DJTI2 6ENAUR 
LD L>fl 
LD (DC 
fiND 07 
LD B.ft 
XOR ft 
SCF 
IRC B 
RLfi 

DJtli BENDS! 

LD (HL). fi 
LD L.8FFH 
LD <ML) .ft 
FOP BC 
JP KBlflTi 



CRICK IF ALPHABETIC 

a - YE5.GENERfiTE 
/4 - ftDORESS BIT 
/S 

flfQC ALL BUT TWO BITS 
ADJUST COM TRUE 
SET UP LOCP CCUfT 
OEAR ft 

CfftRY TO EE SHIFTED IN 

XIERATE address bit 

iSfiVE FDDRESS 
, RESTORE fiSCU DftTft 
iRASX FLL BUT THREE BITS 
, r£AE TO COUNTER 
iOEAR fi 

; CARRY TO EE SHIFTED IN 
,ME COM TRUE 
, GENERATE DftTft BIT 



;SET BIT IN MEnORP.' 

,TY pressed byte 

iSET KEY PRESSED BIT 

; RESTORE REGISTER 

; FINISH BY WING NORMAL 
jr * 

, KEYBOARD interupt routine 
(ft]' ;IS IT CONTROL? 

;V }HUtSRIC OR SPECIAL? 
JRN2.NCM.M 

BIT 4, A i CHECK IF SHIFT 

LD B.10H .SAVE fiDOPESS BIT 

JR, N-- MOSHFT ^ 

LD L.B8H .SHIFT 

LD A.1 i SHIFT BIT 



00758 NOSHFT 
60760 

00778 NOHUH 

00788 

00790 



08810 



00820 VAL1D9 
08848 

08850 CHTRL 



00878 



ID L.B 
JR DATA 
LD B.20H 
fiND 14H i 
JR Z.SHFT 
XOR 14H 
JR Z.5IFT 
JR N05HFT 
CF' RU80UT 
JR NZ.NVALID 
LD HL.CTRLT8 
LD BC.8 
CP1R 



SET ADDRESS Bll 

iSRVE H8RESS BIT 
i CHECK IF SHIFT 

; CHECK IF SHIFT 
i THIS IS BUCK ARROW KEY 



08910 

00920 CTRLTB 
06938 



table address 
iLOOP COUNT 

trlr , ; SEARCH TABLE FtS NATCH 

JR NZ.NVALID ;NOT FOUND 
LD HL.2S48H ; CONTROL BIT FCDRESS 
LOAD LOOP COM 
iCOiPUTE BIT ft® FINISH 



00968 

68970 



LD B.C 
JP. DftTftt 
DEFB SPACE 
DEFB RTAROH 
DEFB RU80UT 
DEFB LF 
DEFB UFAROH 
DEFB ESC 
DEFB ENO 
00990 DEFB CR 

81888 1NTMSK EQU 13H 
01010 KBRD ECU 4 
01028 LFBRKT ECU 58H 
01020 RU80UT EQU 7FH 
81048 'SPACE EGU20H 
01058 RTAROH E9J 9 
01868 LF E8U1B 

01378 UPftROH EOU 08H 
81388 ESC EQU ^H 

01090 ENO ESU 5 

81100 CR EQU CM 

01110 fiTSN EOU 46H 

^ KEYBOARD INTERUPT SERVICE RCMIIE 

01128 ORG 0FC9CH 



01148 KBOINT 
81150 

81160 KBINT1 
81170 
81180 
81190 
81288 
81218 
81228 
01220 
81248 
81250 
01268 
81278 
81280 

81298 TOHON 



PUSH HL 

UHIUCBRDftT iSft.E PWRES5 FCS DftTft 
IN ft, (KBRD) I GET DATA 

ff creLZ** i TO* RETURN TO MONITOR 

UM i enable all interims 

OUT C1NTM5K). ft 
JR Z, TOHON 



01310 

01320 KERDflT 
81330 CTRLZ 
01340 RGSfiYE 
01350 



DEC HL 
SET 8. CHL> 
POP RF 
POP HL 
El 
RET 

POP fiF 
POP HL 
JP RGSfiYE 
EQU 0F02AH 
EQU lfiH 
EQU 8F8C9H 
END 



; IT MRS CONTROL Z 
; POINT TO STATUS MORD 
iSET KESD FLAG 



iENAELE INTERUPTS 
i RETURN FROH INTERUPT 
; RESTORE REGISTERS 
i FOR SAVE ROUTINE 
jSflVE REGISTERS RM> GO TO IWHTOR 



00728 SOFT LD L.S8H .SHIFT ffiDERSS 

IS/C ROM. Program is simpler than , t might * 



DM, and I ordered the Level 



j Ready 

e waiting for the ROMs to 
I wrote a couple of pro- 
to simulate the TRS-80 
are, and I made a couple 
Jware modifications to my 
jter in those areas that 
not be readily done with 
are. The first program, in 
n i simulated the TRS-80 



memory-mapped keyboard. This 
program is an interrupt driver 
that must be used as such. The 
program exits by jumping to my 
normal keyboard interrupt rou- 
tine. . 

As you can see, the normal 
routine checks for a controt-Z 
character and jumps to the mon- 
itor if it detects one. This is an 
invaluable feature of my mon- 
itor. This allows me to always 
jump back to the monitor if for 



some reason the executing pro- 
gram hangs up (except if it dis- 
ables interrupts or destroys the 
monitor RAM area). 

If you don’t have an interrupt- 
driven keyboard, you can t use 
the program in Listing 1, but 
don’t worry, you can still put 
Level II on your computer. It is 
highly desirable that you have 
some method of interrupting the 
computer, saving the registers, 
etc., and jumping back to your 



monitor. It is also necessary 
that you use interrupt mode 2 on 
the Z-80, since the other inter- 
rupt locations are used by Level 
II BASIC. 

If you use Listing 1 with most 
keyboards, you will not be able 
to enter the same character 
twice in a row! The reason for 
this is because when the pro- 
gram sets the bits in memory to 
simulate the TRS-80 keyboard, it 
never resets the bits until the 




eaiea .basic ihuilizatiom routines 

&J118 V ; RICKARD J. USCH3LD 
03123 PCG 
08138 SfflCE 
eai48 chin 
eoisa JPIGRT 
08163 VIDVEC 
e8170 INITVT 

eeisa tvt 
eei» prtvec 

68233 UI£F1> 

08&3 K6DVEC 
88223 JMP4 
08233 KBDST 
e8243 RUeOUT 
60253 BS 
08263 ENG 
08273 CHRCNT 
082S8 TVTOJT 
682S3 OR 
03333 12VI0 
e8313 TOUR 
ee320 IHTtlSK 
C3328 BCOT 
08343 SVPC 
83353 DELRV 
08363 CRET 
68378 TRSCfiS 
86383 V1DJMP 
08330 UPASOW 
03483 NHIVEC 



EQU 1CH 
ECU 0E32EH 
ECU 8F859H 
EQU 8F5CEH 
EQU 431EH 
EQU 0FD93H 
E0U14H 
ECU 4326H 
EQU 4328H 
EQU 4016H 
EQU 8FC59H 
EQU OE033H 
EQU 7FH 
EQU 3 
E8U 5 
EQU 432AH 
EQU 6F36EH 
EQU 8FS4AH 
EQU 33H 
EQU 4312H 
EQU 18H 
EQU 63EH 
EQU 8E851H 
EQU 683 
EQU 80H 
EQU OFFH 
ECU 8EeSBH 
EQU SEN 
EQU 66H 

00418 ; GENERATE TRS-33 GRAPHICS 
88428 ■ ORfi 8F5E9H 

68433 BASIC IN A, (PCG+2) ; DISABLE WRITE PROTECT ON 
68443 ; PROGRAMMABLE CHARACTER GENER3T0R 



68-453 

86453 

03478 

63438 MAIU.P 

88493 CHfiRLP 

e0583 StfTLP 

06513 

e0528 

00533 

03543 

00553 

e0566 

06570 OOTIOP 
K5S8 



LD rt_»33FFH 
ID C.OFFH 
LD D-40H 
LD E, 4 
LD B,2 
RLC C 
RRA 
SRAA 
SRfl R 
SRR fl 

DJNZ SFFTLP 
LD B,4 
LD <HL>,R 
DEC HL 



LRST PRO CHR RODRESS 
DATA FOR LRST CHARACTER 
64 CHARACTER COUNT 
4 DOT ROWS PER CHRR COUNT 
SHIFT LOOP COUNT 
GET DRTfl TO CRRRV 
ROTATE CRRRV TO RCC 
COPY BIT TO FOUR PLACES 



DO NEXT FOUR BITS 
4 LINES PER DOT ROM COUNT 
LOAD DATA TO PRO CHR 
BUMP TO NEXT RODRESS 



08590 


DJNZ DOTLCP 


08683 


DEC E 


08613 


JR N2, CHFiRLP 


88628 


LD R,C 


88638 


SUB 41H 


06640 


LD C.R 


83653 


DEC D 


eC663 


JR NZ.MAIAP 


e8678 


IN A, (PCGES) 



00688 iBFiSIC COflfUWO DECCCE 



00693 

08700 

00713 

88723 

08733 

00743 

e9750 

03768 



CAL SPACE 
CAL CHIN 
CP 'C 



iDO 4 LINES 
iCHRRLODP COUNTER 

i GET DATA FOR NEXT ROW 
GENERATE NEXT DOT ROU 
SAVE NEXT DOT AW 
iHAIN LOOP COUNTER 

iPROTECT MEMORY 

- THE t£XT TWO LINES FEE PARTICULAR TO IT/ MONITOR [ 
TYPES A SFfCE 

GET A CHARACTER FROM KEY6CAR0 AND ECHO IT 
. FOR CONTINUE 



JR Z.RETBAS iCO EKX TO BASIC 



CP 'V 
JP 2,0031 
CP 'R' 

JR NZ# JPIGRT 



FOR INITIALIZE 
INITIALIZE BASIC 
FOR RESET 
1LLEGA CHARACTER 



03768 JK NL, JriUKI i iLLtlrt. tnre-jn-icn rr*«*an 

00773 i THIS ROUTINE PRINTS ILLEGA CHARACTER MESSAGE ft'ti RETUFJIS TO THE HONITOR FOR THE . 

83788 JPN«r.EC iTRS-83 RESET SWITCH 

03798 NOP 

08883 NOP 

08818 NOP 

03823 NOP 

03833 RETEAS LD HLV1DFCH ; INIT VID10 FATCH 

03S48 LD CVIDVEC), A i CHANGE TRS VECTOR 

03858 CAL INITVT jTHIS SETS UP MV TVT P.ND 

88863 ; CLEARS THE SCREER THIS IS PARTICULAR TO IN TVT AS IS THE NEXT LINE 

86870 LD A/OCEH ; NO SCROLL CURSER OFF 

08890 j THIS NEXT SECTION SETS UP A JUMP ADDRESS SO I CAN SWITCH BETWEEN THE HGRHA SPACE 
00908 ; COMPRESSION CODES OR 64 MORE HCCRfiFSSElE CHARACTERS 
08918 LD HL.VIDJMP ;JUrC TO 84A6 DOES SPACE 

LD <A),8C3H ; COMPRESSION CODES. JUMP . 

INC A ;T0 0470 DOES PROGRAMMABLE 

LD <A),0A6H ; CHARACTERS. FROM BASIC, 

INC A iPOKE -3988,125 FOR PRO 
LD <A>, 84H ;CHRS, POKE -3938,166 
;FOR TABS 

LDA.TRSPRT PRINTER DRIVER 
08990 LD (PRTVEC), A 

8ie08 LD HL,KBDSU8 iKEYEOARD SU8TITUTE DRIVER 

01018 LD (KBOVEC), A ; CHANGE TRS VECTOR 

01823 LD A, 57 

01033 LD (LINEPP), A i FAINTER LINES FER PAGE 

01043 NOP 

01353 JP JHP4 » THIS IS THE SECTION IN 

01060 ilf/ MONITOR WHICH RESTORES THE AGISTERS AND RETURNS TO Tffi MAIN 

81070 i PROGRAM - AS FROM A CGHTRCL Z INTERS! 



08933 

88940 

00956 

88968 

08978 



Listing 2. The first part of this program generates the bit patterns necessary to program S ° * 

ulatesthe TRS-80 graphics. The second part sets up my computer so it is compatible with the Level II BASIC ROM. 



RESET FFFO 




ADDRESS BUS A19-AIO 
TO COMPUTER 
2K PULL UP RESISTORS 
ON ALL LINES 



ADDRESS BUS A9-A4 
TO COMPUTER 
2K PULL UP RESISTORS 
ON ALL LINES 



* COES TO SYSTEM SIGNAL 



Fig. 2. Alternate reset vector circuit. Address FFFO must be in PROM and contain a three-byte jump in- 
struction to the start of the monitor. 



next key is hit. If the next key is 
the same as the last one, the 
same bits will be set and the 
ROM will think you have not re- 
leased the key yet! 

There are several solutions to 
this problem. I modified my 
keyboard so it gives a second 
data strobe when a key is re- 
leased. This will strobe in a null, 
and the program will clear the 
memory when the key is re- 
leased. Another solution is to hit 
any key on the keyboard that is 
not encoded by the program. 
This will clear the memory and 
leave it that way. This is only 
necessary if you wish to hit the 
same character twice in a row. 

Actually, I don’t really recom- 
mend you use this program. ! am 
only describing it since it is the 
way I started this project. Later, 
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®8K! 







Photo 2. My completely home-brew system. The first board contains 
the TVT and programmable character generator. Board 2 has my 
front panel logic, the interrupt logic, EPROM programmer, two serial 
ports and the cassette interface, which supports Kansas City S an 
dard, Tarbell, PE2400 Radio Shack Level II and CUTS with a slight 
mod. The third board contains the Z-80 CPU chip, 10K of static RAM, 
3K EPROM the clock switch and "No Memory" interrupt circuit. 
Board 4 is a 12K static RAM board. The fifth board contains a 
joystick interface, Level II ROMs, alternate reset circuit, f'OPPV 
interface, real-time clock and sockets for 32K of dynamic RAM. 








1.78977 MH* 
19.979 2) 



t> GOES TO SYSTEM SIGNAL 



Fig. 3. Clock switch circuit automatically switches the clock from 
the normal frequency (2.5 MHz on my system# to .79 
port FF is written with bit 2 set. It switches back when port FFb.t 2 is 
reset This bit is the TRS-80 cassette motor control bit. 



I’ll tell you what you should use 
and what I am now using. 

Another noteworthy feature 
about this program is the shift. 
The TRS-80 keyboard program 















Photo 1. Level II kit. ROMs have been removed from the circuit board. (Photos by Michael rebellion). 
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generates lowercase characters 

if the shift key is pushed with a 
regular key. It also generates 
special control characters when 
the shift is pushed with the ar- 
row keys. 

I handled this by using the 
eighth bit as the shift bit. My 
keyboard has an extra key that 
sets the eighth bit when pushed. 
Most keyboards don’t have this. 

The second program I wrote 
while waiting for the ROMs is an 
initialization of my system so 
that the ROMs will think they are 
hooked up to a TRS-80. Listing 2 
essentially is the program, al- 
though it is a little bit different. I 
changed it slightly after I got the 
ROMs and learned a few things t 
didn’t originally know. 

The first part of the program 
initializes my programmable 
character generator to simulate 
the TRS-80 graphics characters. 
The programmable character 
generator is essentially the 
same as the one described in 
Byte magazine (May and June 
1978). There are 128 program- 
mable characters that can be 
printed by sending the codes 
80H-FFH to the video driver or 
directly loading these codes in 










TVT memory area. The 
3 . 8 O has 64 graphics charac- 
rs having codes 80H-BFH. 
v hese corresponding charac- 
ters are generated by the pro- 
gram- 

The next section, command 
decode, checks for one of three 
options: initialize, continue or 
reset. The initialize section 
jumps to the ROM so it can ini- 
tialize the Level II RAM area as it 
requires. The reset jumps to the 
BOM, where the reset button on 
the TRS-80 would send it. This is 
used when the Level II hangs up 
and you do not wish to destroy 
the BASIC program in memory. 

On my system, I type a con- 
trol-Z to get back to the monitor 
and then BR. B is the BASIC 
command in my monitor that 
jumps to the program I am now 
describing. R is the reset option. 

The continue option initializes a 
few more things, which 1 11 de- 
scribe later, restores the reg- 
isters and continues where it 
was interrupted (usually by a 
control-Z). I frequently use this 
to save BASIC programs with 
my 2400 baud cassette interface 
rather than use Level ll’s 500 
baud cassette interface. 

I made several hardware 
mods to accommodate the Lev- 
el II ROMs. The simplest was to 
move my RAM, EPROM and i TVT 
RAM to the proper locations. 
The TRS-80 hardware manual 
has a memory map, so this was 
no real problem. The other two 
mods were a bit more involved. 
Both of these mods are for the 
cassette interface. 

The first one (Fig. 3) changes 
the clock speed during the 
cassette operation. Normally 
my computer runs at its rated 
speed of 2.5 MHz; during a cas- 
sette operation, the speed is 
reduced to 1.7898 MHz. This is 
about one percent higher than 
the TRS-80 clock and is more 
than close enough when you 
consider the tolerance of the 
cassette machine. 

The required clock rate is one- 
eighth the rate of my TVT clock, 
so I didn’t require another 
oscillator. The required clock is 
also one-half the color burst fre- 
quency. There are inexpensive 
crystals available that you can 
use; 3.579 MHz color burst 
crystals cost less than $2. 



The other changes are more 
directly related to the cassette 
interface itself (Fig. 4). The out- 
put circuit is little more than a 
couple of latches and a few re- 
sistors. I also added some Tri- 
state buffers so I could use the 

same cable as my 2400 baud in- 
terface. The first input circuit I 
tried is simpler than what the 
TRS-80 has, with three fewer op 
amps and many fewer resistors 
and capacitors. The idea was to 



cnauyo — 

been using with my 2400 baud 

interface as little as possible. 

Well, I was finally ready for 
the ROMs, which would not ar- 
rive for over a month. 

The ROMs Arrive 

After calling the company 
twice, asking where my order 
was, I finally received the ROMs, 
which came on a small circuit 

board with a 24-pin jumper cable 



74129 



cable. No instructions came 
with the kit; however, the hand- 
book shows a schematic of the 
circuit board (Fig. 5). There are 
also other items, including an 
unprogrammed DIP header and 
a resistor, in the kit (see Photo 
1). The DIP header alters the 
ROM decode in the TRS-80; I’m 
not sure what the resistor is 
used for. Anyway, i didn’t use 
either of these. 



USE PIN tO OR II ON T4IT9 
POR MOTOR CONTROL IP DESIREO 




TO DEMODULATOR 
AND CLOCK 
REGENERATOR 



* GOES TO SYSTEM SIGNAL 



CASSETTE PORT WRITE-h( 

PORT FF-lE 
joro-lE 



TRS-80 CASSETTE READ 



, TB o pn I added the Tri-state buffers and changed the 

motor control if you wish. 

Microcomputing, August 1980 



Also included are three prere- 
corded cassettes with some 
very brief instructions on how to 
use them. One cassette con- 
tains Blackjack and Backgam- 
mon. The other two cassettes 
are for conversion of Level I pro- 
grams and data to Level II for- 



mat. I haven’t had a need for 
these two yet, though I have 
used the games a few times. 
Finally, there is the “Level II 
Reference Manual,” along with 
errata sheets, containing useful 
information. 

The small circuit board didn’t 



seem to fit anywhere in my 
system, so I wired up three 
sockets and just removed the 
ROMs. A friend had given me a 
poor copy of a copy containing a 
hex dump of the ROMs and par- 
tial disassembly of the initializa- 
tion portion of the program. The 




Fig. 5. Level II BASIC schematic. (Reprinted from the “TRS-80 Technical Reference Handbook," courtesy 
Radio Shack.) 
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first thing I did was to check the 
first few bytes in each ROM. 
They matched! Next, I ran off a 
hex dump of my own so I could 
read it without straining my 
eyes. 

There was one more thing I 
wanted to do before I actually 
tried to execute the program 
contained in the ROMs. From all 
the information I had acquired, I 
knew that the TRS-80 used inter- 
rupts only when it had the ex- 
pansion interface connected. 



Also, it only used interrupt model O 
1 on the Z-80 chip. Since my I U 



1 on the Z-80 chip. Since my 
system would only work if I used 
interrupt mode 2, 1 searched the 
ROMs for any instructions that 
affected the interrupts. There; 
were two: a disable interrupts ah 
0000 H and an enable interrupts-' 
at 06E4H. 

The enable interrupt instruc- 
tion is actually the interrupt ser- 
vice routine, which is moved to 
RAM during the initialization. 
The routine merely enables in- 
terrupts and returns. This is 
modified when interrupts are 
needed. What all this boilsdowrr 
to is that I shouldn't have any 
problems with my interrupt- 
driven keyboard as long as I 
start the ROM at 0001H. 



The Big Moment 

So, I tried it. The screen 
cleared, and a short message 
appeared in the upper-left cor-i 
ner. it said, ur— 

My computer was talking to me 
in Greek! There was obviously 
some incompatibility between 
the TRS-80 video driver and my- 
TVT. The Level II manual telis 
me that the computer is sup- 
posed to say, “MEMORY 

SIZE? Anyway, I responded 

with a “32000,” which appeared 
on the screen just as I typed it. 

Hmmmm, my keyboard 
kludge was working alright and 
the numerals printed correctly, 7 
but the alphabet was in Greek! I 
hit the carriage return. Nothing- 
happened for a moment, then j 
another couple lines of Greek | 
appeared. ll 

You may be wondering where: 
the Greek was coming from- 
Well, that is an easy one. The: 
character generator ROM • 
bought for my TVT has Greek 
characters and some special 
math symbols where the control 



I P > g- co en 





+ 6 = ‘D' 

+ 7 = ‘O' 

USE PRINTER CONTROL BLOCK 
DCB + 0 = DCBTYPE 

+ 1 = DRIVER ADDRESS (LSB) 

+ 2 = DRIVER ADDRESS (MSB) 

+ 3 = LINES/PAGE 
+ 4 = LINE COUNTER 
+ 5 = 0 Character Counter 

+ 6 = ‘P‘ 

+ 7 = ‘R' 

RESERVED 

cnr INTERRUPT VECTOR 
COMMUNICATIONS INTERRUPT VECTOR 

RESERVED 

- 25 MSEC HEARTBEAT INTERRUPT 
£ RESERVED 

LEVEL II BASIC KAM~ 

[ RESERVEDj Next free byte f or program text, simple 
'\vari 



I variable and arrays 



I/O BUFFER 
ALWAYS ZERO 



- CLOAD start pointer 



4 PROGRAM TEXT 
; SIMPLE VARIABLES 
i ARRAYS 

FREE MEMORY 




SPACE RESERVED FOR MACHINE LANGUAGE 
ROUTINES TO be ACCESSED FROM BASIC - 
IF MEMORY SIZE SET 



20479 (4K) 

32767 (I6K) 

- 28673 = 36863 (20K) 



END OF ACTUAL MEMORY 



as a numeral or a special char- 
acter. So they had to convert 
lowercase to uppercase. It was 
probably simpler to convert both 
upper and lowercase letters to 
control codes than to just 
change lowercase to uppercase. 

Anyway, as far as they were 
concerned, that particular bit 
didn’t really matter because it 
was not even in the RAM! Per- 
sonally, I think they should have 
spent the extra buck on one 
more memory chip, then they 
could have had both upper and 
lowercase on the computer. 

The final solution I came up 
with was to duplicate the first 
dozen instructions of their driver 
and then skip over the section 
that screws up the characters 
and jump back to their driver. 
The total patch is about 40 
bytes. 

Listing 3 shows that I have in- 
cluded two more smali patches 
to the driver. The first changes 
the up-arrow code from 5B 
(which prints a left bracket®} to 
1C, so it prints an up arrow on 
my TVT. Radio Shack mentions 
in the Level II manual that some 
TRS-80s may print the up-arrow 
as a left bracket. The second 
allows me to bypass the space- 
compression codes and print 64 
more of my programmable char- 
acters instead. This is ac- 
complished by poking one byte 
in a memory location. 



the entry point of my video driv- 
er. I was then able to determine 
that the data was always in reg- 
ister C; my driver required the 
data in register A. I patched this 
in and tried again. 

Now 1 was getting data, but 
everything was on the same 
line! There were only carriage 
returns and no line feeds! It 
seems the TRS-80 video driver 
automatically generates a line 
feed when it gets a carriage 
return. As it turns out, my video 
driver generates a carriage re- 
turn if it gets a line feed! So I 
checked for carriage returns 
and converted them to the line 
feeds and tried again. 

Now that was much better! 



Everything seemed to work. 
Well . - . almost everything. The 
clear screen function did not 
work. I know this used to work 
when everything was in Greek. 
Referring again to the Level II 
manual, I noticed they have a 
table that describes all of the 
control codes that are imple- 
mented (Table 1). 

I had two choices: modify my 
video driver to handle all of the 
control codes or try to see if I 
could patch their video driver so 
it would work. Half out of curios- 
ity as to what they were doing 
and why it worked (on a TRS-80) 
and half because 1 didn’t really 
feel like rewriting my driver, I 
disassembled their driver. 



As i had guessed earlier, they 
are converting both upper and 
lowercase letters to control 
codes. The question is, “Why do 
they do this and how come it 
works?” The answer is in the 
hardware manual. It seems they 
thought it would be less expen- 
sive to use only seven bits of in- 
formation in the video RAM in- 
stead of eight. They use one bit 
to select graphics characters or 
regular characters. That leaves 
six bits for the ASCII code. 

But the ASCII code is a seven- 
bit code; how can that work? 
They cheat a little. The seventh 
ASCII bit is generated with a 
NOR gate from two other bits. 
This means that if they sent an 



The Cassette Interface 

Having gotten the video driver 
working made me feel very con- 
fident. I was now ready to attack 
the cassette interface. I placed 
the Blackjack tape supplied 
with the Level II kit in the 
recorder (a Radio Shack CTR-40) 
and typed CLOAD. I have a small 
tape controller box, which en- 
ables me to hear the data while 
the computer is reading it. This 
is convenient because you can 
tell the difference in the sound 
of the actual data and the leader 
tone on the tape. 

I turned on the recorder and 
hit the return key. One nice thing 
about the TRS-80 cassette driver 
is that two asterisks flash in the 
upper-right corner of the screen 
when the computer is reading 
data. The asterisks first appear 
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characters would normally be. 
Most video drivers don’t actually 
send control characters to the 
video RAM; rather, they decode 
them and take the appropriate 
action. For some strange rea- 
son, the TRS-80 video driver was 
changing the normal alphabetic 
codes to control codes before 
sending them to the video RAM. 

The First Program (in Greek) 

I know that some people think 
that programming computers is 
like talking in Greek, but this is 
ridiculous! The Level II manual 
has a short program in the back 
which will display all of . the 
graphics characters. I typed the 
program into my computer . . . 
in Greek! I changed it slightly, 
so it would print all characters 
not including the control codes. 
After 1 finished typing it, I listed 
it. Since I can’t read Greek, I 
couldn’t tell if I had it right or 
not, but at least the list com- 
mand worked. 

Next I typed “txo;” that’s 
RUN, for those of you who don’t 
know Greek. Characters flashed 
by on the screen, and scrolled 
off before I could read them. I 
ran it again, but I halted the 
computer before everything 
disappeared. The special char- 
acters and numerals looked 
good. Then there were two sets 
of Greek characters where 
the uppercase and lowercase 
should be. Next came the graph- 
ics characters, which looked all 
right. 



Fig. 6. Level II TRS-80 memory map. (Reprinted trom “Level II BASIC Reference Manual,” courtesy 
Radio Shack.) I have added a few addresses I have discovered. 



II D/LEVEL II TRS-80 MEMORY MAP 



II 

ADDRESS 



DECIMAL 



HEXIDECIMAL 



12288 



14336 



15360 



16383 

16384 



14302 

14303 
14304-7 
14304-7 
14308-11 
14312-5 
1436-9 



16402 

16405 



16413 



0000 



3000 






3800 



3000 



3FFF 

4000 



37DE 

37DF 

37E0-3 

37EO-3 

37E4-7 

37E8-B 

37EC-F 



4012 

4015 



401D 



LEVEL II BASIC ROM 



RESERVED 



COMMUNICATION STATUS ADDRESS 
COMMUNICATION DATA ADDRESS 
INTERRUPT LATCH ADDRESS 
DISK DRIVE SELECT LATCH ADDRESS 
CASSETTE SELECT LATCH ADDRESS 
LINE PRINTER ADDRESS 
FLOPPY DISK CONTROLLER ADDRESS 



TRS-80 KEYBOARD 
MEMORY 



TRS-80 CRT 
VIDEO MEMORY 






LEVEL II BASIC FIXED RAM 
VECTORS (RST'S 1 THROUGH 7) 



KEYBOARD DEVICE CONTROL BLOCK 

DCB + 0 = DCB TYPE 

+ 1 = DRIVER ADDRESS 
+ 2 = DRIVER ADDRESS 
+ 3 = 0 
+ 4 = 0 
+ 5 = 0 
+ 6 = ‘K’ 
t 7 = 1' 

VIDEO DISPLAY CONTROL BLOCK 

DCB + 0 = DCB TYPE 

+ 1 = DRIVER ADDRESS (LSB) 

+ 2 = DRIVER ADDRESS (MSB) 

+ 3 = CURSOR POS N (LSB) 

+ 4 = CURSOR POS N (MSB) 

+ 5 = CURSOR CHARACTER 




Photo 3. Initial run of Level II BASIC. Translation: 

MEMORY SIZE? 32000 
RADIO SHACK LEVEL II BASIC 
READY 
>_ 



Finally, there were all of those 
spaces, as everything scrolled 
off the screen. The Level II 
manual has a good explanation 
for the scrolling phenomenon. 
The codes, C0H to FFH, are 
space-compression codes for 
0-.63 spaces. So, by printing all 
of those codes, I had printed 
about 2000 spaces to the 
screen. I changed the program 
so it did not print the space- 
compression codes and ran it 
again. This time it didn't scroll 
off the screen. 

Video Driver Patch 

I remembered something I 
had seen in the Level II manual, 
which showed a memory map, 



which had a detailed descrip- 
tion of some of the RAM loca- 
tions used by the Level II BASIC. 
I was interested in a short sec- 
tion of 25 RAM locations con- 
taining three device control 
blocks. There were control 
blocks for the keyboard, the 
video display and the line print- 
er. As you can see from Fig. 6, 
among other things, each block 
contains a driver address. 

Now I figured all I had to do 
was to change the driver ad- 
dress to my own video driver, 
and I would be in business. 1 
tried it. Nothing! I guessed that 
they used a different register to 
transfer the data byte. With this 
in mind, I set up a breakpoint at 
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Fiq. 7. Cassette input circuit I am now using. The 2 kHz high-pass filter is switched in to read Radio 
Shack tapes. The Schmitt trigger section is the same as in Fig. 4. The input latch is simpler than that 
shown in Fig. 4. 



seeming inconsistency is that 
the Radio Shack recording 
method is an amplitude modula- 
tion scheme, while my interface 
is a phase modulation scheme. 
The active filter adds too much 
phase distortion for my inter- 
face to work properly. 

The final circuit 1 implement- 
ed for my cassette interface is 
shown in Fig. 7. The switch Is to 
select Radio Shack or other 
recording methods. I’m not real- 
ly sure if my circuit is more 
or less reliable than Radio 
Shack’s, but my circuit seems 
adequate. Most of the tapes 
read through with two or fewer 
volume adjustments. Some 
don’t need any adjustments. I 
don’t use my Radio Shack inter- 
face to save programs anyway, 
since my 2400 baud interface is 
nearly five times faster. 

One feature of the Radio 
Shack cassette interface I 
haven’t built is the motor control 



computer doesn’t immediately 
respond with READY; if READY 
occurs before the data ends; or 
if the asterisks do not flash. If 
the asterisks flash slowly or er- 
ratically, the load may be bad. 
This clue takes some getting 
used to since the flash rate is 
not the same for all programs. 
You have to get a feel for how 
the asterisks normally flash. 

If any of these symptoms oc- 
cur, you will have to reload the 
program. Several of these prob- 
lems cause the computer to 



hang up. A reset must then be 
issued to get back to BASIC. 

During the next few weeks, I 
tried all of my 100 programs. I 
found that some of the tapes 
read fairly well, while others 
were very poor. These tapes 
have the same programs record- 
ed on both sides as a backup. I 
found that I couldn’t read some 
programs at all; I could read only 
one side correctly on some 
tapes; and I could read both cop- 
ies on others. I tried reading 
some of these programs on a 



i 



01888 iVIDIO DRIVER PfiTCH - 


PRIHTS UPPER RND LftER CftSE 


818% VIDPCH 


LD L, UX+3) 


;GET CURSOR POINTER 


81188 


LD H.UXH) 


;GET CURSOR POINTER 


81113 


JP C.043AH 


;I'H NOT SIRE !*¥lT THIS IS 


61128 


LD ft, ( IX+5> 


i GET CURSOR CHfPfCTER 


81138 


OR ft 




81148 


JR Z, PATCH! 




81158 


LD (HU.fi 




8US8 PATCH! 


LD fi.C 


;GET CHARACTER 


81178 ;TH£ FOLLOWING FEW LINES ADJUST THE IF Kf'M CttE FROM TA£ 
81183 ,TRS-S3 CODE TO TIP EQUIVALENT CODE CH THE CWfcftCTER CEJCRftTCR 


81190 ;HAYE, 


WHICH IS H01S571A 


01288 


CP UFfiROU 


i THIS IS THE UP AEROW CODE 


81218 


JR NZ.PATCH2 


i IS NOT UP ARROW 


81228 


INC C 


iVES ADJUST 


81238 


JP 64S7H 


i DON'T BYPASS UPPER. LCIEP. fiDJ 


81248 RATCH2 


CP ' ' 


; CONTROL? 


812-58 


JP C.858EH 


iVES, DO IT 


81288 


CP 08H 


i GRAPHICS? 


81278 


JP NC, VIDJMP 


;VES. CO IT 


81223 


JP 847DH 


;N0. ALL OTHER 



Listing 3. Patch to the TRS-80 video driver eliminates the section 
that converts lowercase and uppercase character codes to con- 
trol character codes. This permits both upper and lowercase to 
be printed. 



real TRS-80, and some that I 
couldn’t read worked. 

Since my input circuit was 
considerably simpler than the 
one they use, I breadboarded 
their circuit and tried it. It 
worked much better. The volume 
setting was less critical, but it 
was still more sensitive than I 
would have liked. With some ex- 
perimenting, I found that I only 
needed the high-pass filter sec- 
tion of their interface. Since the 
TRS-80 tape format was so 
much improved with the filter, I 
tried it on my 2400 baud inter- 
face. It bombed. My interface 
became totally useless with the 
active filter. 

The reason i attribute to this 



circuit. I’ve been using my cas- 
sette interface for a year and a 
half, and I don’t think a motor 
control is necessary. I do use 
the motor control signal to 
change the clock frequency and 
to enable the output circuit 
though. This works very well. 

Keyboard and Printer Patches 

I decided to get rid of that 
keyboard kludge I was using. I 
wrote the short driver in Listing 
4. This program simply checks 
the keyboard status bit and ei- 
ther returns a null if it is not set 
or returns the character. It also 
checks for and changes two 
characters that were different 
on my keyboard than what the 



TRS-80 Key 


ASCII 


Hex 


Normal Keyboard 


BREAK 


SOH 


01 


CTRL A 




BKSP 


08 


CTRL H 


— ♦ 


HT 


09 


CTRLI 


i 


LF 


0A 


CTRL J 


t 


l 


5B 


[ 


ENTER 


CR 


0D 


RETURN 


SHIFT - 


CAN 


18 


CTRL X 


SHIFT -* 


EM 


19 


CTRLY 


SHIFT 1 


SUB 


1A 


CTRL Z 


SHIFT t 


ESC 


IB 


ESCAPE 


CLEAR 


VS 


IF 





Table 2. Control codes generated by the keyboard driver on the 
Level II BASIC ROMs. Your keyboard must generate these 
characters also. 
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NEWDOS/80 

Powerful Disk Operoring Sysrem for rhe TRS-80 * designed for rhe sophisticated 
user and professionol programmer 

NEWDOS/80 is nor meanr ro replace rhe presenr version of NtWDOS 2.1 which 
sorisfies mosr users, bur is o corefulfy planned upward enhoncemenr. 

• New BASIC Commands wirh vorioble record lengths up ro 4095. 

• Mix or march drives 35. 40. 77. 80TK. 

• Security boor-up for BASIC or mochine code application programs. 

• Improved editing commands. 

• Enhonced RENUMBER rhor oHows relocarion. 

• Device handling for rouring ro display ond prinrer simulroneously. 

• CDE function: striking of C. D. and E keys allows user ro enter a mini-DOS. 

• Compatible wirh NEWDOS and TRSDOS 2.3. 

• Superzap 3.0 and 2.1 utilities. 



NEW DOS FOR APPLE® "APEX" 

The complete APEX package with operating sysrem, 
assembler, editor and user manuals. The package also includes j, — , 
o complete set of utilities ro maintain files on single or multiple Q 
drive systems. (Specify 5 inch Apple disk or 8 inch disk.) # Jf 



RELATED SOFTWARE 
XPLO *79 

FOCAL” »59 



SAVE ON APPLE II 16K 

FREE MTt MEMORY UPGRADE KIT TO 48K 
WITH PURCHASE OF APPIE II 16K 

Ml 95 



(MTt ONLY) 




16K RAM 
MEMORY KIT 



TRS-80® SOFTWARE 

NEW DOS*- 05 trock >99 

AJA Word Processor *89 

AJA Ousiness Program *289 

Disk Drive Alignment Program ..*109 
Radix Daro (tee Program .... *99.95 

MOD I ”8" DISK SYSTEM 

• One SAMOA 005 aid Coble 

• 2 Dove Chassis ond Paver Supply 

M095 

TRS-80® DISK DRIVES 



DISK DRIVE SALE! 

$70 worth of FREE merchandise wirti pur 
chose of Shugarr SA400 wrh power supply 
ond chassis. The dish Thor Radio Shock sells 
for $499 

SAVE $200 $399 

. $389 
. $389 
. $639 
. $499 
$4995 



TF-1 Perrec FD200. 40 frock 

TF-5 MPI 051 . 40 rrock 

TF-70 Miaopolis. 77 rrack . . . 
TDH-1 Dual sided. 35 rrack . 
MAX Disk 2: 1 0 Megabyte . . 




DISK DRIVE SYSTEM 



• 2 Shugon SAxiOO 
wirh povef /chassis 

• Coble 

SPECIAL PRICE ONLY 



• interface 32K 
» 1 35-Trock D05* 

>1199 



★ DARE DRIVES FOR ANY MICROCOMPUTER* 

Perrec FD200 $282 FD250 1359 

Shugarr SA400 $279 SA600 $479 

MPI B52 $349 D51 $279 

®Registered trode mark of Radio Shock and Apple 



OKI DATA PRINTER 

LIST $1009 $£OQ 

OUR PRICE # OW 




PRINTERS 



Centronics 779 $1067 ANADEX $923 

Centronics 737 $937 70CM $1193 

Centronics 701 1 $1773 702 2 $1993 

Spinwrirer-NEC $2349 

Dose 2 Prinrer 60. 132 col. grophia/rrocators $399 




/MlCROCOmJER 

.TECHNOLOGY 
ii INCORPORATED ^30 



3304 W. MacArthur 
Santa Ana, CA 92704 
(714) 979-9923 




ASK FOR FREE 
CATALOGUE 



✓ 349 



pparat, Inc. 



7310 E. Princeton Ave. 
Denver, CO 80237 
(303) 741-1778 

Telex #678401TA8IRIN 

All PRICES CASH DISCOUNTED • FREIGHT FOD FACTORY 



when the actual data on the 
tape starts, just after the leader 
tone ends. They then flash as 
each line of program is read. 

Somewhat to my surprise, the 
asterisks appeared and began 
flashing as soon as the leader 
tone ended. As soon as the data 
ended, the computer typed 
READY. I typed RUN. The pro- 
gram started executing! It 
asked me several questions, in- 
cluding my name. 

After my second or third re- 
sponse, the program bombed. 
Oh well, I knew it was too good 
to be true. I adjusted the volume 
on the recorder and tried again. 
After several repeats of the 
above, the program actually ran 
all the way through. Ah, success 
at last. Next, t tried making a 
tape. I had to adjust the volume 
several times to get it to read 
back correctly, but this also 
worked. 

The volume setting on the 
tape recorder is critical. I usually 
have to adjust it several times 
before I can get a program to 



load correctly. 

I bought the Library 100 from 
The Bottom Shelf, Inc. This is e 
five-cassette package of 100 
assorted programs for the 
TRS-80. I have to adjust the 
volume several times even to 
read programs on the same 
cassette. According to the hard- 
ware manual, the data on the 
cassette is saved with a 
checksum. This is useful for 
detecting load errors. 

The only problem Is that the 
Level II cassette loader program 
does not check the checksum 
and tell you when a bad load has 
occurred. My own cassette 
loader does this, and while I 
don’t have frequent errors, it 
sure is nice to know that the 
load is bad before you try to ex- 
ecute the program. 

I have discovered several 
ways to help determine if a load 
is good or not. The load will be 
bad If the asterisks appear be- 
fore or after the point on the 
tape where the data actually 
starts; If the data stops and the 



Code 


Hex 


Function 


0-7 


00-07 


None 


8 


08 


Backspaces and erases 
current character 


9 


09 


None 


10-13 


0A-0D 


Carriage returns 


14 


0E 


Turns on cursor 


15 


OF 


Turns off cursor 


16-22 


10-16 


None 


23 


17 


Converts to 32 character 
mode 


24 


18 


Backspace -* Cursor 


25 


19 


Advance *- Cursor 


26 


1A 


Downward t linefeed 


27 


IB 


Upward i linefeed 


28 


1C 


Home, return cursor to 
display position(0,0) 


29 


ID 


Move cursor to beginning 
of line 


30 


IE 


Erases to the end of the line 


31 


IF 


Clear to the end of the frame 



Table 1. Control codes decoded by the video driver on the Level II 
BASIC ROMs. (Reprinted from “ Level II BASIC Reference 
Manual,” courtesy Radio Shack.) I have added hex codes. 
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gram’s attention is with an inter- n 
rupt. If you have an interrupt- t 
driven keyboard, you could use tl 
a program such as Listing 1 to c 
simulate the TRS-80 memory- £ 
mapped keyboard, as I did at £ 
first. Otherwise, you need some j 
other means of interrupting the 
computer. This could be as sim- 
ple as a switch to the interrupt 
line on the Z-80. The interrupt 
service routine could simply 
change the keyboard driver ad- 
dress and then return to the 

Level II program. 

There are only two situations 
where you could get by without 
any interrupts. If you actually 
connect, your keyboard the 
same way as Radio Shack did, 
you wouldn’t need interrupts. If 
you already have a keyboard 
connected some other way, re- 
wiring it is probably unde- 
sirable. Or, if you have a hard- 
ware front panel, you could in- 
terrupt the computer that way 
and change the keyboard driver 
address. While that is not really 
very difficult, it is kind of a 
bother to flip all those switches. 
My system includes a front pan- 
el, and I didn’t want to do it that 
way. 

The method 1 used to interrupt 
the computer is a bit unusual for 
a microprocessor. I have a cir- 
cuit in my computer that gen- 
erates an interrupt if the com- 
puter attempts to read a mem- 
ory address at which there is no 
memory installed (see Fig. 8). 
This interrupt saves all the 
registers, prints a “No Memory 



message and jumps to my moni- . 

tor. When the ROM tries to read 
the keyboard, this interrupt is 
generated because I don’t have 
any memory there. From here I 
simply type BC, a monitor com- 
mand that stands for BASIC 
Continue. 

Listing 2 is the program. Its 
function is very simple— it mere- 
ly sets up the new driver ad- 
dresses for the keyboard, TVT 
and the printer. Then it restores 
all the registers and returns to 
where it was interrupted. 

TVT Specifics j 

If your TVT is a memory- 
mapped device with 16 lines of 
64 characters, you should have 
no problems getting it to work 
with Level II BASIC. You will 
have to change its address to 
3COO-3FFF. If you don’t have a 
programmable character gener- 
ator, you will have to modify the 
TVT to implement the TRS-80 
graphics. The modification 
should consist of only three ICs 
as shown in Fig. 9. 

Fig. 10 shows the graphics- 
character format. As you can 
see, each character cell is divid- 
ed into six blocks. Each block is 

t controlled by one bit in the video 

r memory. The most significant 
bit determines if a particular 
r character is a graphics charac- 
ter or a regular character. The 
multiplexers simply steer the 
0 bits to the appropriate posi- 
j tions. 

e This circuit will work for TVTs, 
which have a character cell con- 



<, SCAN LINES ' D4 OS 

l I t J L_i 

• A DOTS 1— 



rTUIsUlsIzTTFl VIDEO RAM DATA 



00glg^ed four industry . 
priced for the home. 




B/Ilfeo Of The video 100 computer 

monitors are ideal for all your personal and business needs. 
These highly reliable 12" black and white monitors fea.ure 
a 12 MHz band width and 80 character by 2 “1 ‘ 1 ^ ^ 
Plug-in compatability with Apple, Atari, Radio Shack, O.S.L 
Sufrd-Term and Exidy make these the perfect text display 
for almost any system. UNDER $160.00 










ONE CHARACTER CELL 15 12 SCAR LINES i ST 5 DOTS 
THIS DRAW IRC IS ARPR0A1MATELT TO SCALE. 

Fig. 10. Scale drawing of one character cell shows that each 
graphics dot is approximately twice as tall as it is w,d _ 

RAM bits that control each graphics dot are also show . 
matches the circuit in Fig. 9. 



‘ jOEB mm SD The model 80 fea- 
tures an industrial grade metal cabinet with buUgn d^k 

mounting capability and space for an 11 x 14 PC board 

for custom designed electronics. 

The solid state circuitry assures a sharp, staple, ana 
trouble-free picture. The front panel controls include power, 
rontrast horizontal hold, vertical hold, and brightness. Ad- 
SsSis lor S. videi level, and widlh are located on 

the rear panel. UNDER $200.00 

VIDEO 100 AND VIDEO 100-80 SPECIFICATIONS 

. 12" diagonal measure • Convenient front panel 

display oaali COntr ° 3 

• Video band width 12 MHz # input impedence 75 Ohms 

. 80 character by 24 line • 90% deflection picture tube 

display . 

• Video 100-80 provides mounting space for mini floppy 

. Resolution -Over 700 lines at center horizontally- 
over 350 lines at center vertically. ^59 



2420 E Oakton SI • Arlington Heights. Illinois. 60005- l312l 364-1180 - TLX: 25-4786 J 
Dealer discou nt available 
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81300 

01318 

ei328 

ei338 

01348 

01350 

81363 

01378 

01368 

01398 

01480 

01418 

01428 

81433 

81443 

01453 

01453 

01478 

81488 

81490 

81580 

81510 

81520 

81538 



©581 



TKv-80 SUBSTITUTE ©Y8GARD DRIVER 
^SU8 ID HUKED5T ;©Y60ARD STATUS ADDRESS 
BIT 0.<HL> 

;VES, ITS RERDV 
iNOT READY 
i RETURN KITH fi NULL 
; RESET STATUS BIT 
;&W> POINTER TO DATA 
;GET DATA 
; IS IT A RUBOUT? 
iNO 

Y£S» LOAD BACKSPACE 
AND RETURN 

THIS IS FOR CLEAR KEY 
NOT CLEAR. RETURN 
YES. LOAD CLEAR CODE 
;AND RETURN 

S™C* »TA TO CORRECT REG 

U) HL.CHRCNT ; GET POINTER 
CP 8CH ;FORN FEED 

JR Z.F0RHF i INITIALIZE LINE COUNT 

i CARRIAGE RETURN 
iDO CARRIAGE RETURN 
iGET CHAR COUNT 



81548 

81558 

81560 



CP 46H 
CELL 2.CR 
ID A.C 



©382 



JR HZ.KBS81 
SR A 
RET 

RES 8. <HL) 
INC a 
LD A. (a) 

CP RU80UT 
JR NZ.KES82 
LD A.BS 
RET 

CP EN9 
RET NZ 
LD A.1FH 
RET 



81578 TRSPR1 CPU TYPOUT 



CP BDH 
JRZ.CR 
LD A,<a> 



i=64? 

INSERT A CR IF =64 
iGET DATA AGAIN 
; OUTPUT CHAR TO PRINTER 
BUMP CHAR CCUHTER 
iDCNE 

POINT TO LINE COUNT 
GET LINE CCUHT 
POINT TO LUES PER PAGE 
BUM> LINE COUNT 
AT LIMIT? 

i POINT TO LINE COUNT 
YES. AT LIMIT 
iSfiVE aw LINE COUNT 
; POINT TO CHAR COUNT 

reset char own 

jGET A CARRIAGE RETURN 
DO CARRIAGE PETIRH 
POINT TO LINE COUNT 

ss 

81758 ;THIS ALLOWS ME TO PUT ANOTHER PfCE IN W PRINTER 
w’fR SR A iCLEAR A 

MW ™CR1 = FINISH BY DOING CR 



015S0 
81590 
81680 CR 
01618 
01620 
01633 
81648 
81658 
01668 
81678 CR1 
81688 
81690 
81780 
81710 

81720 FORMF 



inc ca> 

RET 
DEC a 
id A.<a> 

DEC a 
INC A 
cp <a> 
inc a 

JR Z.NXTPAG 

id cho.r 
inc a 

ID <a).0FFH i 
LD A. BOH 
JR TRSPR1 
DEC a 



ui5*z3 LU ruvri./ • 

ii dqm if works in conjunction with my nor- 



ing 4Conv»ua uwrww. ... r 

the special code required by my 
modified Olivetti Lexikon 82 
typewriter. The form-feed check 
in the program permits resetting 
the line counter to zero. This 
should be used before any new 
listing, so it starts at the top of a 
new page. From BASIC, the fol- 
lowing line will work: LPR1NT 
CHR$(12);. 



BOM expected. 

Actually, there were more 
characters that didn't quite 
match, but I reprogrammed my 
keyboard encoder EPROM to fix 
those. The reason I didn’t fix ail 
of them on the EPROM is be- 
cause I would have had to 
change my monitor that used 
those characters. I figured it 
was better this way. Table 2 
shows the control characters 
generated by the TRS-BO key- 
board. 



The printer patch adds a few 
features that my driver didn’t 
have but are assumed by the 

Level II ROMs. The major feature 

is to add extra carriage returns 
when a line exceeds 64 charac- 
ters in length. My first printer 
patch did not do this, and when I 
listed BASIC programs that had 
multiple statement lines longer 
than 64 characters, the extra 
characters would not print. I 
also added a lines-per-page 
counter. When the line count is 



at the limit, the program waits 
for me to put another page in my 
printer. 

The routine TYPOUT in List- 



Specific Hardware 
Requirements 

The single most important 
hardware requirement for your 
system is the use of interrupts. 
The reason for this Is the way 

the keyboard is set up. When the 

Level II ROM initializes Its RAM 
space, it assumes that you have 
a memory-mapped keyboard. If 
you don’t have a memory- 
mapped keyboard and you don’t 
have interrupts either, there is 
no way you can talk to the Level 
II program, and the computer 

will be hung up. 

The only way to get the pro- 



FROM LATCH 
AND VIDEO RAM 



FROM 

TIMING CHAIN 



back plane wire 






74 

367 



> DATA BUS 



« I 

I ^ HO^E^ H 



7407 
OPEN COLLECTOR 



DATA TO BUS 





TO INTERRUPT 
CIRCUIT 
HIGHEST 
PRIORITY 



7412 S OR 74363 

OR 74367 

TRI STATE DRIVER 



5SKSVH , « e, 5S!»'ST:igi 



pafe to every hoard in you y f/m(? g nonexiste nt memory ad- 

*»««<» »» ***•> “ re " 

rupt in your system. 




-^OOTS TO VIOtO »I*I» 



gre i 
rupi 
driv 
a pi 
sim 
mai 
firs 
oth 
cor 
pie 
line 
ser 
chi 
dre 
Le' 



wt 

an 

ca 

sa 

yc 

yc 

cc 

w 

si; 

w 

te 

ai 

at 

VI 

b 

h 



CLOCK . 

Fig 9 TM. w* 2“r m™* 'yoJV.VT ' 1 mm* 

will be similar. 
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sistLng of 12Jines of eight dots. 

If your TVT has 12 lines of six 
dots, simply tie the two outputs 
from mux A to each of three in- 
puts on mux B instead of the 
four shown. If your TVT has a dif- 
ferent arrangement of lines and 
dots, you have several choices. 

First, you could stretch or 
shrink some of the graphics 
dots so they fill the available 
lines and dots in the character 
cell. This may cause some 
graphics dots to be different 
sizes than other ones if the total 
number of lines and dots are not 
evenly divisible by three and 
two, respectively. 

Second, you could modify 
your TVT so it has a line count 
divisible by three and a dot 
count divisible by two. This is a 
bit tricky and should be attempt- 
ed only after you have examined 
the schematic and understand 
the timing details of the TVT. 
The first mod is simpler and 
doesn’t affect the timing, but 
you should still closely examine 
the schematic of your TVT be- 
fore attempting to install the 
change. 

Third, you could forget about 
the graphics. This is the sim- 
plest solution, but since a lot of 
game programs use the graph- 
ics, you may not want to do this. 
If you never play games, then 
you don’t need the graphics any- 
way. 

I suggest you try the first solu- 
tion before trying the second. 
The slightly different size dots 
will go unnoticed in many ap- 
plications anyway. My own TVT 
has a software-selectable char- 
acter cell size. I can select 13 by 
9 or 12 by 8. 1 normally operate in 



the 13 by 9 mode and have found 
it satisfactory in many graphics 
applications. 

If your video terminal is a 
completely separate unit from 
your computer, you obviously 
don’t have a memory-mapped 
device. This means you can’t 
use any part of the TRS-80 video 
driver. You will have to either 
write your own or modify the one 
you are presently using. The 
most important thing is to have 
the control characters respond 
correctly (see Table 1). 

There are a few features in 
Level II BASIC that won’t work 
with this type of setup. The 
graphics functions, SET, RESET 
and POINT, won’t work, al- 
though you could send the 
graphics characters to the 
terminal like any other char- 
acter. The PRINT @ and POS 
commands won’t work either. 
Everything else should be fine 
though. 

Your First Run 

When you first try to run the 
Level II BASIC, you may have a 
different sequence of events 
than I do, depending on just how 
your hardware is configured. As 
you recall, my first run produced 
Greek characters. I no longer 
get Greek when I initialize the 
BASIC ROM. The first thing that 
appears is a ‘‘No Memory” mes- 
sage. This occurs when the 
ROM attempts to read the key- 
board memory. I then type BC 
(BASIC Continue). 

As described earlier, this 
changes some of the RAM loca- 
tions just initialized by the ROM 
and returns to Level II BASIC. 
From here, my system behaves 



just like a TRS-80. 

If you don’t have a "No Mem- 
ory” interrupt on your system, 
and depending on what your 
TVT does with control charac- 
ters, your system could produce 
Greek characters, some strange 
graphics characters or ab- 
solutely nothing. The next 
display will depend on what you 
have in the keyboard memory 
area. If this memory is all zeros, 
you will only see one line of 
whatever characters your 
system is producing. If the 
memory is all ones (FF hex) or 
random data, you should see 
several lines of these characters 
continously being written to the 
TVT and scrolling off the screen. 

No matter what you see, you 
should now hit your interrupt 
button (control-Z, or whatever) 
to put you back into monitor. 
After typing the BASIC Continue 
command, you should have a 
blank screen. 

The ROM is now waiting for 
your response to the MEMORY 
SIZE question, even though you 
can’t see that message. Typing 
anything should cause it to ap- 
pear on the screen. Since there 
may be several unknown char- 
acters in the keyboard buffer, 
you should first delete these 
with the back-arrow key. When 
the cursor stops moving back, 
all characters have been delet- 
ed. Now answer the MEMORY 
SIZE question as you wish. If 
you hit a carriage return with 
garbage data, the ROM will ask 
the MEMORY SIZE question 
again. 

One final note: if, on your 
system, memory address 
37ECH returns anything other 



than 00 or FFH when read, the 
ROM may attempt to boot the 
disk. I’m not sure exactly what 
will happen, but it will most like- 
ly get hung up and do nothing. If 
you have no memory at that ad- 
dress, you should be OK, since 
most systems read FFH or 00 to 
nonexistent memory. 

Conclusions 

For someone with a Z-80 
microcomputer system who is 
looking for a good BASIC and 
would prefer to have it on ROM, 
Radio Shack's Level II ROM add- 
on kit for their TRS-80 is a good 
way to go. The price is reason- 
able— less than many BASICS 
that only come on cassette. If 
you consider the additional cost 
of EPROMs to put another BA- 
SIC on ROM, the Level II BASIC 
is less expensive than any other 
I know. 

That the TRS-80 is the most 
popular microcomputer today 
ensures that there will be more 
directly compatible software 
than any one person can use. 
The ROM also contains a floppy 
disk bootstrap routine. This 
allows easy addition of one or 
more mini-floppy disk drives for 
a more versatile system. Radio 
Shack’s TRSDOS may not be the 
best, but at only $14.95, it cer- 
tainly is the most inexpensive 
disk operating system I have 
ever seen.H 
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